/ Celestin Apprentice 2 / Apprentice-Release2.iso / Tools / Languages / Python 1.1 / Doc / libgrp.tex

< prev

next >

MacOS 8.1

Win98

DOS

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 73 65 63 74 69 6f 6e | 7b 42 75 69 6c 74 2d 69 |\section|{Built-i|
|00000010| 6e 20 4d 6f 64 75 6c 65 | 20 5c 73 65 63 74 63 6f |n Module| \sectco|
|00000020| 64 65 7b 67 72 70 7d 7d | 0d 0d 5c 62 69 6d 6f 64 |de{grp}}|..\bimod|
|00000030| 69 6e 64 65 78 7b 67 72 | 70 7d 0d 54 68 69 73 20 |index{gr|p}.This |
|00000040| 6d 6f 64 75 6c 65 20 70 | 72 6f 76 69 64 65 73 20 |module p|rovides |
|00000050| 61 63 63 65 73 73 20 74 | 6f 20 74 68 65 20 5c 55 |access t|o the \U|
|00000060| 4e 49 58 7b 7d 20 67 72 | 6f 75 70 20 64 61 74 61 |NIX{} gr|oup data|
|00000070| 62 61 73 65 2e 0d 49 74 | 20 69 73 20 61 76 61 69 |base..It| is avai|
|00000080| 6c 61 62 6c 65 20 6f 6e | 20 61 6c 6c 20 5c 55 4e |lable on| all \UN|
|00000090| 49 58 7b 7d 20 76 65 72 | 73 69 6f 6e 73 2e 0d 0d |IX{} ver|sions...|
|000000a0| 47 72 6f 75 70 20 64 61 | 74 61 62 61 73 65 20 65 |Group da|tabase e|
|000000b0| 6e 74 72 69 65 73 20 61 | 72 65 20 72 65 70 6f 72 |ntries a|re repor|
|000000c0| 74 65 64 20 61 73 20 34 | 2d 74 75 70 6c 65 73 20 |ted as 4|-tuples |
|000000d0| 63 6f 6e 74 61 69 6e 69 | 6e 67 20 74 68 65 0d 66 |containi|ng the.f|
|000000e0| 6f 6c 6c 6f 77 69 6e 67 | 20 69 74 65 6d 73 20 66 |ollowing| items f|
|000000f0| 72 6f 6d 20 74 68 65 20 | 67 72 6f 75 70 20 64 61 |rom the |group da|
|00000100| 74 61 62 61 73 65 20 28 | 73 65 65 20 5c 66 69 6c |tabase (|see \fil|
|00000110| 65 7b 3c 67 72 70 2e 68 | 3e 7d 29 2c 20 69 6e 20 |e{<grp.h|>}), in |
|00000120| 6f 72 64 65 72 3a 0d 5c | 63 6f 64 65 7b 67 72 5f |order:.\|code{gr_|
|00000130| 6e 61 6d 65 7d 2c 0d 5c | 63 6f 64 65 7b 67 72 5f |name},.\|code{gr_|
|00000140| 70 61 73 73 77 64 7d 2c | 0d 5c 63 6f 64 65 7b 67 |passwd},|.\code{g|
|00000150| 72 5f 67 69 64 7d 2c 0d | 5c 63 6f 64 65 7b 67 72 |r_gid},.|\code{gr|
|00000160| 5f 6d 65 6d 7d 2e 0d 54 | 68 65 20 67 69 64 20 69 |_mem}..T|he gid i|
|00000170| 73 20 61 6e 20 69 6e 74 | 65 67 65 72 2c 20 6e 61 |s an int|eger, na|
|00000180| 6d 65 20 61 6e 64 20 70 | 61 73 73 77 6f 72 64 20 |me and p|assword |
|00000190| 61 72 65 20 73 74 72 69 | 6e 67 73 2c 20 61 6e 64 |are stri|ngs, and|
|000001a0| 20 74 68 65 20 6d 65 6d | 62 65 72 0d 6c 69 73 74 | the mem|ber.list|
|000001b0| 20 69 73 20 61 20 6c 69 | 73 74 20 6f 66 20 73 74 | is a li|st of st|
|000001c0| 72 69 6e 67 73 2e 0d 28 | 4e 6f 74 65 20 74 68 61 |rings..(|Note tha|
|000001d0| 74 20 6d 6f 73 74 20 75 | 73 65 72 73 20 61 72 65 |t most u|sers are|
|000001e0| 20 6e 6f 74 20 65 78 70 | 6c 69 63 69 74 6c 79 20 | not exp|licitly |
|000001f0| 6c 69 73 74 65 64 20 61 | 73 20 6d 65 6d 62 65 72 |listed a|s member|
|00000200| 73 20 6f 66 20 74 68 65 | 0d 67 72 6f 75 70 28 73 |s of the|.group(s|
|00000210| 29 20 74 68 65 79 20 61 | 72 65 20 69 6e 2e 29 0d |) they a|re in.).|
|00000220| 41 6e 20 65 78 63 65 70 | 74 69 6f 6e 20 69 73 20 |An excep|tion is |
|00000230| 72 61 69 73 65 64 20 69 | 66 20 74 68 65 20 65 6e |raised i|f the en|
|00000240| 74 72 79 20 61 73 6b 65 | 64 20 66 6f 72 20 63 61 |try aske|d for ca|
|00000250| 6e 6e 6f 74 20 62 65 20 | 66 6f 75 6e 64 2e 0d 0d |nnot be |found...|
|00000260| 49 74 20 64 65 66 69 6e | 65 73 20 74 68 65 20 66 |It defin|es the f|
|00000270| 6f 6c 6c 6f 77 69 6e 67 | 20 69 74 65 6d 73 3a 0d |ollowing| items:.|
|00000280| 0d 5c 72 65 6e 65 77 63 | 6f 6d 6d 61 6e 64 7b 5c |.\renewc|ommand{\|
|00000290| 69 6e 64 65 78 73 75 62 | 69 74 65 6d 7d 7b 28 69 |indexsub|item}{(i|
|000002a0| 6e 20 6d 6f 64 75 6c 65 | 20 67 72 70 29 7d 0d 5c |n module| grp)}.\|
|000002b0| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|000002c0| 67 65 74 67 72 67 69 64 | 7d 7b 67 69 64 7d 0d 52 |getgrgid|}{gid}.R|
|000002d0| 65 74 75 72 6e 20 74 68 | 65 20 67 72 6f 75 70 20 |eturn th|e group |
|000002e0| 64 61 74 61 62 61 73 65 | 20 65 6e 74 72 79 20 66 |database| entry f|
|000002f0| 6f 72 20 74 68 65 20 67 | 69 76 65 6e 20 6e 75 6d |or the g|iven num|
|00000300| 65 72 69 63 20 67 72 6f | 75 70 20 49 44 2e 0d 5c |eric gro|up ID..\|
|00000310| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0d 0d 5c |end{func|desc}..\|
|00000320| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00000330| 67 65 74 67 72 6e 61 6d | 7d 7b 6e 61 6d 65 7d 0d |getgrnam|}{name}.|
|00000340| 52 65 74 75 72 6e 20 74 | 68 65 20 67 72 6f 75 70 |Return t|he group|
|00000350| 20 64 61 74 61 62 61 73 | 65 20 65 6e 74 72 79 20 | databas|e entry |
|00000360| 66 6f 72 20 74 68 65 20 | 67 69 76 65 6e 20 67 72 |for the |given gr|
|00000370| 6f 75 70 20 6e 61 6d 65 | 2e 0d 5c 65 6e 64 7b 66 |oup name|..\end{f|
|00000380| 75 6e 63 64 65 73 63 7d | 0d 0d 5c 62 65 67 69 6e |uncdesc}|..\begin|
|00000390| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 67 65 74 67 72 |{funcdes|c}{getgr|
|000003a0| 61 6c 6c 7d 7b 7d 0d 52 | 65 74 75 72 6e 20 61 20 |all}{}.R|eturn a |
|000003b0| 6c 69 73 74 20 6f 66 20 | 61 6c 6c 20 61 76 61 69 |list of |all avai|
|000003c0| 6c 61 62 6c 65 20 67 72 | 6f 75 70 20 65 6e 74 72 |lable gr|oup entr|
|000003d0| 69 65 73 20 65 6e 74 72 | 69 65 73 2c 20 69 6e 20 |ies entr|ies, in |
|000003e0| 61 72 62 69 74 72 61 72 | 79 20 6f 72 64 65 72 2e |arbitrar|y order.|
|000003f0| 0d 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0d |.\end{fu|ncdesc}.|
+--------+-------------------------+-------------------------+--------+--------+